Skip to main content

Get Position Information

Type GET

Description: /future/user/v1/position/list

Parameters

NameTypeMandatoryDefaultDescription
symbolstringNoN/ATrading pair (queries position information for all trading pairs when not provided)

Limit Flow Rules

200/s/apikey

Request Example

Request
curl -G "https://fapi.xt.com/future/user/v1/position/list" \ 
-H "validate-appkey: $APPKEY" \ # Required
-H "validate-timestamp: $TIMESTAMP" \ # Required
-H "validate-singature: $SINGATURE" \ # Required
-H "Content-Type: application/x-www-form-urlencoded" \ # Required
-d "symbol=btc_usdt"

Response Example

Response
{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": [
{
"autoMargin": false, // Whether to automatically call margin
"availableCloseSize": 0, // Available quantity (Cont)
"closeOrderSize": 0, // Pending order quantity (Cont)
"entryPrice": 0, // Open position average price
"isolatedMargin": 0, // Isolated Margin
"leverage": 0, // Leverage
"openOrderMarginFrozen": 0, // Occupied open position margin
"positionSide": "", // Position side
"positionSize": 0, // Position quantity (Cont)
"positionType": "", // Position type
"realizedProfit": 0, // Realized profit and loss
"symbol": "" // Trading pair
}
],
"returnCode": 0
}

Error code

Error codeDesc
invalid_symbolSymbol does not exist